Summary

• Treat an existing docs.json without docs.config.* as the source of truth for docs cloud init.
• Preserve frameworkless docs.mode, runtime root, content roots, existing cloud feature choices, and existing docs-cloud extensions.
• Add Cloud init defaults directly to docs.json without creating a native docs.config.ts sidecar.
• Keep repeated docs cloud init runs idempotent for docs-json-only projects, even when Fumadocs dependencies/config files are present.

Validation

• pnpm --filter @farming-labs/docs exec vitest run src/cli/cloud.test.ts
• pnpm --filter @farming-labs/docs typecheck
• pnpm exec oxlint packages/docs/src/cli/cloud.ts packages/docs/src/cli/cloud.test.ts
• pnpm exec oxfmt --check packages/docs/src/cli/cloud.ts packages/docs/src/cli/cloud.test.ts && git diff --check
• pnpm --filter @farming-labs/docs build
• Built-CLI smoke matrix for: native docs.config.tsx, frameworkless docs.json, framework-backed docs.json without config, fresh Fumadocs connect, fresh framework config creation, and docs.json with Fumadocs signals.

Summary by cubic

Use an existing docs.json as the source of truth for docs cloud init when no docs.config.* exists. Preserves frameworkless settings, writes cloud defaults to docs.json (no docs.config.ts), and keeps repeat runs idempotent.

• Bug Fixes
  • Uses docs.json as init input and writes defaults (apiKey env, deploy enabled, analytics) back to it.
  • Keeps existing docs.mode, runtime/root, and content roots unchanged; subsequent runs are a no-op.

^{Written for commit 96671cb. Summary will update on new commits.}